###User Defined Function###
_WinAPI_CreateStreamOnHGlobal

###Description###
Erzeugt ein Streamobjekt welches ein Speicherhandle verwendet um die Inhalte des Streams zu speichern.

###Syntax###
#include <WinAPICom.au3>
_WinAPI_CreateStreamOnHGlobal ( [$hGlobal = 0 [, $bDeleteOnRelease = True]] )

###Parameters###
@@ParamTable@@
$hGlobal
	[optional] Das Speicherhandle. Wenn dieser Wert 0 ist (Standard) so wird ein neues Handle stattdessen erstellt. Das Handle muss als verschiebbar und nicht entsorgbar allokiert werden.
$bDeleteOnRelease
	[optional] Gibt an, ob das unterliegende Handle für dieses Streamobjekt automatisch freigegeben werden soll, wenn das Streamobjekt freigegeben wird. Gültige Werte sind:
		True	- Die letzte Freigebung wird automatisch den $hGlobal Parameter freigeben (Standard).
		False	- Der Nutzer muss $hGlobal selber nach der letzten Freigabe freigeben.
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg: Der Pointer zum neuen Streamobjekt.
Fehler:	0 und setzt @error auf einen ungleich 0 Wert. Das @extended Flag kann den HRESULT Fehlercode enthalten.
@@End@@

###Remarks###
Wenn $hGlobal 0 ist, so allokiert die Funktion ein neues Speicherhandle und der Stream ist ursprünglich leer, anderenfalls sind die ursprünglichen Inhalte des Streams die des aktuellen Inhalts des Speicherblocks.
Deshalb kann <a href="_WinAPI_CreateStreamOnHGlobal.htm">_WinAPI_CreateStreamOnHGlobal()</a> verwendet werden um ein bereits existierenden Stream im Speicher zu öffnen. Das Speicherhandle und dessen Inhalt werden durch das Erstellen des neuen Streamobjekts nicht verändert.

Nachdem ein Streamobejt mit <a href="_WinAPI_CreateStreamOnHGlobal.htm">_WinAPI_CreateStreamOnHGlobal()</a> erzeugt wurde, sollte <a href="_WinAPI_GetHGlobalFromStream.htm">_WinAPI_GetHGlobalFromStream()</a> verwendet werden um das aktuelle Speicherhandle, welches mit dem Streamobjekt assoziiert ist, zu holen.

Um ein Streamobjekt freizugeben sollte man die <a href="_WinAPI_ReleaseStream.htm">_WinAPI_ReleaseStream()</a> Funktion verwenden.

###Related###
_WinAPI_GetHGlobalFromStream, _WinAPI_ReleaseStream

###See Also###
@@MsdnLink@@ CreateStreamOnHGlobal

###Example###
@@IncludeExample@@
